[Top] [Prev] [Next] [Bottom] [Contents]

SgeSetColBind

Sets a column binding for an allocated data structure which is used to execute a Stored Procedure or DSQL Object. This function is used in generating Sapphire/Web code and probably will not be used by application programmers. It is documented here so that you can understand Sapphire/Web-generated code.

Synopsis

#include "WorkingDialog.h"
void SgeSetColBind(pSgeWorkCallData p, Widget dest, 
							int group, int order, int size,
							PopulationCallback cbfunc, 
							XtPointer client);

Arguments

p
An allocated pSgeWorkCallData structure.
dest
Widget that results are sent to data site string.
group
Results group number.
order
Order specifier used when multiple columns are sent to the same Data Site, dest.
size
Size of column from database table. Use 0 if unknown.
cbfunc
Pointer to a PopulationCallback function. If NULL, dest must be a valid Widget.
client
Client data to pass to callback function.

Return Values

None.

Description

SgeSetColBind sets a column binding for an allocated pSgeWorkCallData structure. If p is NULL, no action is taken. This should be called for each column that a Stored Procedure or DSQL Object returns. It must appear in the same order as indicated by the bound Stored Procedure or DSQL Object. The parameter, dest, specifies which widget to bind to. This must be a valid Widget or NULL if cbfunc is NULL. The parameter group specifies the results group number for this column. Each select statement in a Stored Procedure or DSQL Object is a results group. The first select statement has a group number of 1.

The order parameter specifies the order in which columns will appear in the resulting callback structure. If multiple columns are bound to the same destination for a results group, the size parameter specifies the size of a column in bytes. The column bytes should be the same size as those given in the table definition for the database. If not known, 0 should be specified. The parameter, cbfunc, is a pointer to a PopulationCallback function. The parameter, client, is the client data passed to this callback function.

Example

pSgeWorkCallData pSgeWCD;
extern void MyCallback();
....
SgeSetColBind(pSgeWCD, UxGetWidget(scrolledList1), 1, 1, 80, 
MyCallback, (xtPointer)0);

See Also



[Top] [Prev] [Next] [Bottom] [Contents]

info@bluestone.com
Copyright © 1997, Bluestone. All rights reserved.